home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / mus / edit / soundzapv3_0.lha / SoundZAP.doc < prev    next >
Text File  |  1992-06-05  |  10KB  |  175 lines
  1. SoundZAP v3.0:
  2.  
  3.  
  4. Description:
  5.     SoundZAP is a program for converting sound files of various formats into
  6.     IFF 8SVX, Raw, or Sun .au files.
  7.  
  8. Background:
  9.     One of the amazing things about the Amiga is its incredible sound support.
  10.     Its BUILT-IN sound hardware is capable of playing sound of higher quality
  11.     than most of the add-on sound hardware for other platforms. So when I got
  12.     access to InterNet earlier this year I was amazed that most of the sound
  13.     files posted in the alt.binaries.sounds.* newsgroups were NOT posted by
  14.     Amiga users, and therefore were not in the Amiga standard IFF 8SVX format.
  15.     I then looked around for a program that would convert these files into a
  16.     format that I can use easily (i.e. 8SVX). The largest help came from Dave
  17.     Champion (dgc3@midway.uchicago.edu) who gave me a copy of a program he
  18.     wrote called "mac2raw". But, that program still only gave RAW signed data.
  19.     I wanted 8SVX files. So we hacked around a while working on writing a
  20.     multi-format sound convertor. Dave and I worked for a few weeks on it but
  21.     finally we both got too busy to give it much more thought. Then two months
  22.     or so later I got inspiration! I found ulaw28svx, by Michael Boehnisch
  23.     (billy@uni-paderborn.de) somewhere. It worked great for converting ulawed
  24.     files and it gave me the output I wanted, so I sat down and re-wrote the
  25.     program we had been working on before from scratch. I got the ULAW and RAW
  26.     convertors to work, and before I knew it I had what you now have before
  27.     you!
  28.  
  29. Capabilities:
  30.     This program converts sound files of the following formats: RAW (signed,
  31.     unsigned, and ulaw-ed), .AU files, .VOC files, .WAV, Macintosh, AIFF, and
  32.     IFF 8SVX sounds. It outputs either IFF 8SVX files, RAW data, or .au files.
  33.     It auto detects the .VOC, .AU, .WAV, Macintosh, AIFF, and 8SVX headers,
  34.     converting them appropriately. You can force the program into using a
  35.     certian sample rate for the output file. You can also force it ignore any
  36.     headers and convert the file as if it were just RAW data. It can use a
  37.     variable buffer size and convert samples of any length. There are a few
  38.     other command line options that will be discussed later.
  39.  
  40. Filenames:
  41.     You can supply both input and output filenames, or just an input filename.
  42.     If you only give an input filename the program will strip any 2 or 3
  43.     character extentions (i.e. '.snd' or '.au') and append an extention that
  44.     is descriptive of the output format. '.iff' for 8SVX, '.au' for Sun AU,
  45.     and '.raw' for RAW output. If a file exists with the same name as the
  46.     output file IT WILL GET OVERWRITTEN!!! So be careful. If the source
  47.     filename has the same name as the output file SoundZAP will give you an
  48.     error.
  49.  
  50. Command Line Options:
  51.     All options are a minus sign followed by a letter. Some have numerical
  52.     arguments which should follow the letter (no space between the letter
  53.     and the number).
  54.  
  55.         -a<n> : Amplify the data by n thirds. It takes the value of the data
  56.                 and multiplies it by n/3. If the data is already fairly loud
  57.                 and n is too large, this switch may cause major distortion.
  58.                 If n isn't there (or 0) then the program will search the file
  59.                 for the sample with the largest value (i.e. the loudest) and
  60.                 map that to the loudest value possible (i.e. 127). This will
  61.                 make the file as loud as possible with NO distortion apart
  62.                 from noise that is already present (actually there may be SOME
  63.                 distortion due to rounding...but not much).
  64.  
  65.         -b<n> : This will change the size of the buffer the program uses while
  66.                 converting the sample. If you have only a small amount of
  67.                 memory you may have to use this switch, but remember: the
  68.                 larger the buffer the faster the conversion. The default is
  69.                 50K and n is in K, so "-b1024" would create a 1024 kilobyte
  70.                 (or 1 Megabyte) buffer. If n is not there (or 0) then the
  71.                 program will try to allocate a buffer that is the same size as
  72.                 the sample. This can speed up the conversion of samples quite
  73.                 a bit...if you have enough memory.
  74.  
  75.         -c<n> : This will take data, sampled at one rate, and convert it to
  76.                 data with a different sampling rate. This only works if you
  77.                 are converting from a high sample rate to a lower rate (i.e.
  78.                 22790 -> 8000). 'n' can have the following values:
  79.  
  80.                                         5  = 5696  samples/sec
  81.                                         7  = 7596  samples/sec
  82.                                         8  = 8000  samples/sec
  83.                                         1  = 11395 samples/sec
  84.                                         2  = 22790 samples/sec
  85.  
  86.                 This switch will also accept explicit declarations of the
  87.                 sample rate, not just the above abbreviations. Just enter
  88.                 the sample rate right after the '-c' on the command line.
  89.                 Example: "-c2203" would convert to 2203 samples per second.
  90.  
  91.         -f    : Force the program to assume the input data is RAW. Use this if
  92.                 the header of a file is corrupted and SoundZAP is choking on
  93.                 it. You may then have to edit the sample to get rid of any
  94.                 headers or other non-sample data that doesn't get stripped.
  95.                 This switch assumes SIGNED data, so if the output sounds VERY
  96.                 noisy then use the -u switch along with -f to toggle it.
  97.  
  98.         -l    : This will cause the program to output u-lawed data. This
  99.                 switch is implied in the -s switch.
  100.  
  101.         -n    : This will cause the program to only output the VHDR and BODY
  102.                 chunks to an IFF file, and not the AUTH, ANNO, and (c) chunks.
  103.                 If a sample player seems to choke on a converted sample try
  104.                 using this option. It only has an affect if the output is an
  105.                 IFF 8SVX file.
  106.  
  107.         -r<n> : This changes the sample rate for the output data. This switch
  108.                 overrides any headers in the source file. This DOES NOT
  109.                 physically change the data, just the rate that a sample player
  110.                 program will play the file at. It is only useful when
  111.                 outputting IFF 8SVX or .au files. The <n> can be any vaild
  112.                 rate as explained in the -c switch.
  113.  
  114.         -s    : This will cause the program to output a Sun .au file. The data
  115.                 is re-sampled to 8000 samples per second and converted to
  116.                 u-lawed bytes. There is no need to use the -l switch with this
  117.                 option.
  118.  
  119.         -u    : Output UNSIGNED data. It can also be used to toggle the format
  120.                 of the data if you use the -f switch on unsigned data.
  121.  
  122.         -w    : Output RAW data...no headers.
  123.  
  124. Registration:
  125.     I am not asking for any money for this program. It was not that difficult
  126.     to write and I enjoyed doing it. If YOU feel obligated to send something
  127.     what you could do is send me any information on sound formats that you
  128.     think would be useful for future versions. That would probably be the most
  129.     helpful thing you could do.
  130.  
  131. Updates:
  132.     I will try to keep the most up-to-date versions on FTP sites for people
  133.     with FTP access. Since ab20 went down, I will keep new versions on
  134.     amiga.physik.unizh.ch.  If you don't have FTP access I can send you the
  135.     latest version via Internet E-Mail. Finally, I can Snail-Mail you the
  136.     latest version if you have no other way of finding it, but you'll have to
  137.     send me enough money to cover the price of a disk and postage. When you
  138.     get a new version PASS IT AROUND! Upload it to BBS's and other FTP sites
  139.     so people can find it!
  140.  
  141. Thanks:
  142.     Thanks to everyone who has sent me mail! I've recieved alot of very
  143.     helpful information...especially bug reports and suggestions. Thanks!
  144.  
  145. Author:
  146.     Michael Cramer (mrc113@psuvm.psu.edu || mrc@ecl.psu.edu)
  147.  
  148.     You can contact me at the above E-Mail addresses from September through
  149.     May. You can also Snail-Mail me anytime at the following address:
  150.  
  151.                        Michael Cramer
  152.                        1015 Lindbergh Ave.
  153.                        Stroudsburg, PA 18360
  154.  
  155.     Use E-Mail if you can, becasue it's MUCH faster for me.
  156.  
  157.     You can also e-mail me at infestix@hogbbs.scol.pa.us. That will be there
  158.     forever (or at least for the next 2 or 3 years!) but I don't check it
  159.     quite as often. If you have any suggestions or comments that don't need
  160.     immediate attention you can mail them there.
  161.  
  162. If you find ANY bugs or things you think should be changed contact me and I'll
  163. do my best to fix them. Please don't make any changes to my source, mail me
  164. and I'll release a fixed version. The source is provided as a learning tool.
  165. It may be used in your own programs (if you mention me! =) if it is NOT going
  166. to be for profit!
  167.  
  168. If you have the specifications and/or a sample of another storage format please
  169. mail it to me. I can only support formats that I have access to, and I don't
  170. have time to look all over the place for different formats. Thanks!
  171.  
  172. See the file "history" for release history and future plans.
  173.  
  174. This version of SoundZAP was compiled with DICE version 2.06.40 in June of 1992.
  175.